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1.0 INTRODUCTION 

1.1 Motivation 

Updates to DIGITAL hardware/ software manuals have oc 

been supplied: single sheets of paper containing 
which the . user is obliged to make by pen and ii 
manual. This method is not only burdensome for t! 
creates problems for Hardware and Software 
maintaining manuals. A standard, easy-to-use updats 



customers t< 



1.4 Related Current Standards 

; Updates generally conform to standards defined for hardware/ softwar< 
manuals. In cases where the update is to a manual produced ii 
non-standard format, however, the update must reflect the format ol 
the manual. For example, running heads are not appropriate on ai 
update if the parent manual itself was produced with no running heads 
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1. 


An update 


is a parital change 


to a published manual. 


2. 


A revisioi 


i isa total replacem 


ent of a published manual. 


3. 


The terms 


addendum and change 


notice are not recognized as 



3.0 DEFINITION- OF THE STANDARD 

3.1 Rationale For Updates 

ites n 
:ed bE 

To supply missing information. 

To provide information about added features. 

To document changes to existing products. 

3.2 Update Format 

Updates are published as complete pages to be added to, or to rej 
pages in the manual to which the update applies. Each page contc 
new or changed information will be identified by a date in the 
right corner in the form: 

month year 

For example: 

May 1976 

The lower left corner of the page is to be used for the soi 
system version number, when applicable. 

Replacement 
when text 
to a page c . _ 

4-point border tape or equivalent will be used for change 
Change bars are not placed on pages that contain complete! 
information, however. Such pages are identified by the date, 
system version number if applicable. 

Deletions ai e indicated by a bullet (.) in the outside m« 
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; opposite the line(s) in which the deletion occured. Deletion of a 
complete line is indicated by a bullet placed between the preceding 
and following lines. When the entire paragraphs are deleted, a bullet 
appears in the margin, opposite tha blank line that preceded the 
deleted paragraph(s) . 

NOTE 

The outside margin of an odd-numbered 
page is the right margin. For an 
even-numbered page it is the left 



Page Numbering 

t;xt is added to a page, following text sometimes "overflows", 

will not fit on the page. When this happens on the last page of 

ipter, there is no problem. A page is simply added to accommodate 

overflow. This page becomes the last page in the chapter and is 
ired accordingly. When overflow occurs at the beginning, or in 

middle of a chapter, it creates a problem. If the overflow is 
red to flow through the rest of the chapter, all remaining pages 
:he chapter must be revised and reprinted, a costly process. To 
1 this, a "point" page is used to pick up the overflow. 



A point page is simply a short page which immediately follows the page 




)w text; it is 


numbered by adding a "point" to the preceding page. 




separated from the page number by a decimal point. e.g. 


., 2-16.1. 


Example: Text is added to page 2-16, causing an c 


overflow. The 


material pushed off page 2-16 is moved t 


:o a point page 


numbered 2.16.1. The user receives pages ; 


2-15/2-16, and 


2-16.1 backed up by a blank page. He/she te< 


irs out the old 


2-15/2-16 sheet, and inserts the ne 


;w 2-15/2-16, 


2-16.1/blank sheets. Back-up pages are di 
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Lred for 

it-numbered pages that end on odd-numbered points (e.g., 2-16.3) 
a bit awkward, since they must be backed up by a blank page; the 
: page in the above instance being 2-17, a right-hand page. But 
; isn't" a real problem, since the reader's eye tends to fall 
irally on the right-hand page. 

:a text put on an even-numbered (left-h£.nd) page overflows to an 
-numbered point page (e.g., 2-16.1). Extra text put on an 
-numbered page overflows to the next even-numbered page, which in 
i may overflow, again to an odd-numbered page (e.g., 2-15/2-16, 
j.l) . In any event, the even-numbered page would have to be 
ited, since it backs up the preceding odd-numbered page. 

NOTE 

In cases where a page deletion results 
in a blank odd-numbered page (e.g., the 
text on 2-15 is deleted) , the text on 
that page is replaced by the notation 

This page intentionally left blank 

The page number 



jnchanged. The d 

: right corner of the pag 



3 differ^it page: 



zm»:i 



The title page of an update contains instructions 01 
the update. It appears in the following fore 
brackets delimit variable fields that must be fillet 
They do not actually appear on the page.) 

UPDATE NOTICE #2 

name of affected manual 



NEW AND CHANGED INFORMATION 



Abstract of changes and addit 
contained in the update. Indicate i 
previously published updates 
superseded, if any. 



The following pages are to be placed 
the name of affected manual 
replacements for, or additions 1 
current pages. 



Ther( 



i poir 



replaced. Replacing 30% 
Note: this applies to repli 
constitute 30% replacement, 
text (e.g., a new chaptei 
■simple operation, does not 
supervisor is responsible foi 
rather than updated. 



0-pag. 

ment i 

Adding oi 

deciding when 



ately 

anua'l is not a trivial tas 
es. An add-on of 30% does i 
eplacing a 60-page block 
an be put in the manual in < 
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rent format as of August 


the format 


established by the SDC. 



3.9 Order Numbers 

An update is numbered identically to the manual it affects, exc« 
that the code Nz is appended to the number. The value of z indicat 
whether the update is the first (1), second (2), etc. published 1 
the manual. (The form of the order number will follow tt 
established by the Software Distribution Center.) A revision 
indicated by incrementing the appropriate field of the order number 

For example, when the manual DEC-11-ABCDE-A-D is revised, the ore 

DEC-11-ABCDE-B-D 

Any update pages carried over as 
stripped of their change bars 
renumbered, in the course of repagi 
that the order numbers shown above 
18, 1975. Order numbers conform to 



When updates exist for a manual, and the manual is to be reprinted, 

the updates are incorporated into the manual. To reflect the new 

status of the reprinted manual, the update codes are added to the 
manual order number, as follows: 

DEC-11-ABCDE-A-D; DN1 , DN2 

This indicates that the copy of this manual contains the updates 
numbered 

DEC-11-ABCDE-A-DN1 and 
DEC-11-ABCDE-A-DN2 

but that the manual itself is not a revision. Thus, the revision 
The order number that appears on the 
ilso changed to reflect inclusion of the 
:ice should not be included in the reprint, 
reader . A NEW AND CHANGED INFORMATION 
i the Preface indicating the fact that the 



field re 


mains 


unchanged. 




comments paqe is , 


updates. 




Update No 


since it 


would ( 


:onfuse the 


paragraph 




included ii 


update ha 


s been 





DEC STD 143 



This standard applies to all hardware and software manuals produced by 
the Software Documentation group, and Hardware Technical Documentation 
group, except documents (such as perfect-bound handbooks) that are not 
intended to be updated. 

The practices and procedures described apply to updates made to 
individual hardware/software manuals. Any current practices of 
combining individual updates into composite packages for distribution 
on monthly, semi-annual, etc. basis are not affected by this 
standard . 



